home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 001 / calltym2.arc / CALLTIME.DOC next >
Text File  |  1987-07-16  |  13KB  |  236 lines
  1.                                         CALL TIME
  2.                                          V - 1.1
  3.                               Shareware by BRAND Consultants
  4.                                       P.O. Box 2425
  5.                                   Brattleboro, VT 05301
  6.  
  7.                           (C)Copyright, 1987 All Rights Reserved
  8.                                     BRAND Consultants
  9.  
  10.           Description:
  11.  
  12.                CALL TIME is a communications program that will automatically
  13.                dial the U.S. Naval Observatory Computer in Washington, DC,
  14.                establish handshaking with it and download the correct time and
  15.                date into your system, automatically.  It is corrected for leap
  16.                years, and allows you to select the particular time zone, and
  17.                Standard or Daylight time.
  18.  
  19.                If you have a real-time clock, with compatible software, this
  20.                clock can be reset by this program.
  21.  
  22.                Since other data is available from the USN Observatory computer,
  23.                this program will allow you to switch from automatic to manual
  24.                operation after communications handshaking, to enter requests of
  25.                your own.  Other information available include Tides & Moon
  26.                Phases, Sidereal Time, Sunrise/Sunset for any point...etc.
  27.                Enter  @TCO  when in manual mode, and you will be given a list of
  28.                commands.  Be sure your printer is operating.  You are limited to
  29.                30 minutes or 15 commands, whichever comes first.
  30.  
  31.                The USN Observatory computer operates only at 1200 baud, Even
  32.                parity with 7 data bits and 1 stop bit.
  33.  
  34.           Requirements:
  35.                IBM-PC,XT,AT with at least 256k of RAM
  36.                DOS 2.x or later.
  37.                Hayes 1200, 1200B or 1200 baud modem with a command set that is
  38.                nearly identical to Hayes command set.
  39.                To set real-time clock:
  40.                Software that will re-set the clock board from BASIC, by setting
  41.                TIME$= to the downloaded time.
  42.  
  43.  
  44.                                CALL TIME INSTRUCTIONS
  45.  
  46.           Operation
  47.                The disk contains three files...
  48.                     CALLTYM2.EXE - The main program (Ver. 1.1)
  49.                     MODDAT.TDT   - Ascii data file used by the program.
  50.                                    This file must be on the same diskette
  51.                                    or in the same directory on a hard disk
  52.                                    as the main program.
  53.                     CALLTIME.DOC - This document file, in ascii.
  54.  
  55.           First:
  56.                Copy the main program and the data file to a working diskette, or
  57.                onto your hard disk in whatever directory you wish.
  58.           Second:
  59.                Before attempting to log-in to the USN Computer, you must
  60.                establish an Identification String that the USN computer will
  61.                accept.  It is quite particular about the format of this ID
  62.                String.  There is an ID string in the data file, but the USN
  63.                computer will not accept this, so you must press 'R' to revise
  64.                the data file, at the main menu and create your own ID string.
  65.                This ID (in caps) consists of 'YOUR NAME' a space 'INITIALS OF
  66.                YOUR ORGANIZATION' a space 'CITY' a space '2 LETTER STATE CODE'.
  67.                An example would be:
  68.                     J.J.SMITH/R.C.A./ALBANY NY
  69.                The main criteria is to keep it short !
  70.  
  71.                After the ID string, the next item is the Modem Reset string.
  72.                For Hayes and Hayes compatible modems this is 'ATZ'.  This is
  73.                sent to the modem to cancel any prior set-up commands in
  74.                preparation for a new set-up.  The default set included in the
  75.                data file is 'ATZ'.
  76.  
  77.                Next is the modem set-up string that configures the modem
  78.                parameters for this program.  You will need your modem manual to
  79.                be able to change this.  The important part of this is that the
  80.                program is looking for the words 'CONNECT' and 'NO CARRIER' as
  81.                returned by the modem to determine if connection was made or not.
  82.                We suggest you not change this item, unless you are thoroughly
  83.                familiar with your modem and it's operation.
  84.                                CALL TIME INSTRUCTIONS
  85.  
  86.                The next item that you can and may want to change is the modem
  87.                dial string.  The default is 'ATDT1' which is the Hayes command
  88.                to start tone dialing with the number 1.  If you need to add a
  89.                long-distance access code, you would add it to the end of this
  90.                string.  The USN Observatory phone included in the data file, has
  91.                the area code 202 with it.  If you live inside this area, you
  92.                will need to modify the phone number in the data file MODDAT.TDT
  93.                with a word processor program to remove the area code.
  94.  
  95.                Next, is the Communications Port Number.  This is the port number
  96.                that your is assigned to your modem, or to the RS232 connection
  97.                where your modem is fastened.  These are identified as COM1 thru
  98.                COM2.   Simply press the number, 1 or 2 to assign the correct
  99.                port number.  The default is 1, for COM1.
  100.  
  101.                The last item you need to change is the time-zone in which you
  102.                live.  Simply press the number in front of the proper time-zone
  103.                and it will be stored in the data file.
  104.  
  105.                The Revise data file option allows you to revise 5 items in the
  106.                data file directly.  If you have a modem with a command set that
  107.                is not equal to the Hayes Command set, you can revise other modem
  108.                commands in this data file, using a word processing program that
  109.                allows you to alter ASCII files, such as Wordstar, Wordperfect,
  110.                PC-Write or many others.
  111.                The order of items in this file, and their default values is as
  112.                follows:
  113.  
  114.                "COM1:"            port where modem is connected
  115.                "J.ROSCOE HACKERHEIMER/ANOTHERCOMPANY/ALMOSTANYWHERE US"
  116.                "PLS IDENTIFY"     transmitted by USN to request log-in
  117.                "@TIM"             sent to USN to request time
  118.                "@BYE"             logoff (also ^D which is chr$(4))
  119.                "*"                transmitted at start of time signal
  120.                "2026531079"       Observatory phone number
  121.                "ATZ"              reset modem
  122.                "ATE1F1M1Q0V1S0=0" modem set-up string
  123.                "ATDT1"            modem dial command
  124.                "CONNECT"          returned by modem on connection
  125.                "NO CARRIER"       sent by modem if connection not made
  126.                2                  time standard desired (2= East Day Time)
  127.  
  128.                NOTICE - all items have quotation marks around them, EXCEPT the
  129.                last, which is a numeric value and must not have quotes.
  130.                DO NOT USE QUOTATION MARKS when entering data from the main
  131.                program.  These will only appear when viewing the file with a
  132.                word processing program.....
  133.                                CALL TIME INSTRUCTIONS
  134.  
  135.                If the file MODDAT.TDT is missing or damaged, never fear !
  136.                CALLTIME.EXE will create a new one with the values given above.
  137.  
  138.                After you have selected the time-zone number the new data will be
  139.                written to the moddat.tdt file and the program will return to
  140.                modem set-up, so that any changes you made will be initiated
  141.                immediately.
  142.  
  143.                You will then be returned to the main menu.
  144.                Now, to set your system time, just press A and hang on!
  145.  
  146.                Everything is automatic and does not require any input from you,
  147.                and you will be able to watch the process on the screen.  After
  148.                the time is set, you will have 5 seconds before the systems
  149.                disconnects.  If you press the Esc key, you will be switched to
  150.                manual input mode which will allow you to ask for any additional
  151.                information.
  152.                The USN Observatory will not allow you to waste any time, and
  153.                will disconnect if you make too make mistakes or if 20 seconds
  154.                elapse without an entry.
  155.                If you want to capture this process on your printer, press Ctrl
  156.                and PrtSc and be sure your printer is on, and on-line with lots
  157.                of paper.  To stop the printer, press Ctrl PrtSc a second time.
  158.                Please be aware, if your printer is slow, the resulting time
  159.                setting may not be correct, as the printer will slow the process
  160.                down.
  161.  
  162.           MANUAL MODE
  163.  
  164.                If you press M at the main menu, you will be switched to a normal
  165.                'dumb' terminal mode.  You can manually enter phonenumbers to
  166.                dial and operate this like any dumb terminal.
  167.  
  168.           CORRECTING TIME OF REAL-TIME CLOCKS
  169.                Correcting your real-time clock board is automatic, if your clock
  170.                software has an option that allows setting the board
  171.                from Basic by setting the TIME$ = to current time.  For AST
  172.                boards and some other compatibles, adding /r to the end of the
  173.                'astclock' or 'timer' command will load the resident time & date
  174.                processors.  You must do this before running CALLTIME.
  175.                                CALL TIME INSTRUCTIONS
  176.  
  177.           PROGRAM NOTES on Version 1.0
  178.                Version 1.0 contained significant bugs.  There are some anomalies
  179.                in the time formulas that will give incorrect readings when the
  180.                program is run during certain times of the day.  Another bug
  181.                crept into it, that prevented switching to manual mode, after
  182.                connecting to the Naval Observatory.  Version 1.0 would not
  183.                operate at 'Turbo' speed or 8mhz.  This was finally determined to
  184.                be a lack of enough communications buffer.
  185.  
  186.           PROGRAM NOTES on Version 1.1
  187.                All bugs that could be found have been corrected.  The
  188.                communications buffer has been increased to 2048 bytes, and in
  189.                our tests with a Turbo XT machine have run successfully.  In
  190.                order to overcome some of the problems associated with testing
  191.                and also the significant cost of repeated calls to Washington, DC
  192.                we devised a simulation program and connected two computers
  193.                together.  The simulation program could be set for any time or
  194.                date between the years of 1980 to 1999.  After that date, someone
  195.                else is going to have to come up with a program to cope with the
  196.                21st Century.
  197.  
  198.  
  199.           REGISTRATION
  200.                 To become a registered user of this program, and receive new
  201.                updates and any new informtion regarding it's use, send $12.50
  202.                to:
  203.  
  204.                     Call Time Registration
  205.                     Brand Consultants
  206.                     P.O. Box 2425
  207.                     Brattleboro, VT 05301
  208.  
  209.                We are always interested in your feedback, and will make every
  210.                effort to make additions and revisions according to your
  211.                suggestions.
  212.  
  213.           COPYRIGHT NOTICE
  214.                Copyright 1987 by Bruce D. Anderson.  All Rights Reserved. This
  215.                publication and enclosed software has been provided pursuant to a
  216.                restricted agreement concerning it's use.  No part of either
  217.                publication may be disclosed to third parties by any means, or
  218.                copied by any means, or transmitted by any means without the
  219.                express written permission of BRAND Consultants, P.O. Box 2425,
  220.                Brattleboro, VT 05301.
  221.  
  222.           DISCLAIMER
  223.                Bruce D. Anderson dba BRAND Consultants makes no representation
  224.                or warranties with respect to the contents hereof and
  225.                                CALL TIME INSTRUCTIONS
  226.  
  227.                specifically disclaims any warranties, however made, implied or
  228.                otherwise, as to suitability, merchantability or fitness for any
  229.                particular purpose.  BRAND Consultants reserves the right to
  230.                revise this publication and associated software, and make changes
  231.                to the content hereof without obligation to notify, upgrade or
  232.                replace either product for any and all licensees of these
  233.                products.
  234.  
  235.  
  236.